APPENDIX 


PowerTalk Built-in Templates 


This appendix describes some of the details of the AOCE templates that are built 
into PowerTalk. You can use this information to gain access to the information in 
these templates or to provide additional templates that work with and extend the 
built-in templates. AOCE templates are described in the chapter "AOCE Templates" in 
this book. 


User Records 


User records have a record type of aoce User (kUserRecTypeBody). 

There are several standard attribute types in a User record. You can add new attribute 
types to User records, but each new attribute type must have a unique name. To ensure 
the uniqueness of the attribute type, start it with a four-character application signature 
registered with Apple Developer Services. 

Attribute type aoce mailslots (kMailSlotsAttrTypeBody) contains the list of 
addresses for the user. The preferred address is duplicated in attribute type aoce pref 
mailslot (kPrefMailAttrTypeBody). 

Attribute type aoce Personlnfo contains the text information found on the first User 
record information page (the Business Card page). The following lookup table describes 
the format of the information: 

resource ' dett ' (kUserlnf oPageAspect + kDETAspectLookup, purgeable) 



{"aoce Personlnfo"}, typeBinary, 

useForlnput, useForOutput , notlnSublist, isNotAlias, isNotRecordRef , 
{ 'rstr', kName, 0, 

' rstr ' , kTitle, 0, 

'rstr', kCompanyName , 0, 

'rstr', kCompanyAddr , 0, 

' rstr ' , kMisc , 0 } ; 


Attribute type aoce Picture contains the picture found on the first User record 
information page. 

resource 'dett' (kUserlnfoPageAspect + kDETAspectLookup, purgeable) 

{ { 

{"aoce Picture"}, typeBinary, 
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useForlnput, useForOutput , notlnSublist, isNotAlias, isNotRecordRef, 
{ 'rest', kPicture, 0 }; 


Attribute type aoce Personal contains the information found on the second User record 
information page (the Personal Info page). 

resource ' dett ' (kUserlnfoPageAspect + kDETAspectLookup, purgeable) { { 

{"aoce Personal"}, typeBinary, 

useForlnput, useForOutput, notlnSublist, isNotAlias, isNotRecordRef, 

{ 'rstr', kPersonall, 0, 

'rstr', kPersonal2 , 0, 

'rstr', kPersonal3 , 0 }; 

1 }; 


Attribute type aoce PhoneNumber contains one value per phone number in the third 
User record information page (the Phone Numbers page). The tag of each value tells the 
type of phone number: 'work' for work, 'home' for home, 'mobi' for mobile, and 
' othr ' for other. You can add new tags, but you must be careful to avoid duplicate use 
of the same tag. The attribute values have the following format (using ' work ' as an 
example — the other types vary only in the tag, not in the internal format): 

resource 'dett' (kWorkPhoneAspect + kDETAspectLookup, purgeable) { 

{ 

{"aoce PhoneNumber"}, 'work', 

useForlnput, useForOutput, notlnSublist, isNotAlias, isNotRecordRef, 

{ 

'rstr', kDETAspectName, 0; 

'rstr', kPhoneNumber , 0 ; 

'rstr', kPhonelnfo, 0 


}; 


Attributes of type aoce mailslots are used both in User records and in stand-alone 
attributes and are described in "Addresses" on page A-4. 

The User record information pages are 350 pixels wide by 180 pixels high. The page 
selection pop-up menu is fixed at location (6, 180, 24, 339) (top, left, bottom, right). If you 
add your own information page to a User record, it is recommended that you include a 
page-identifying small icon at location (6, 156, 22, 172). 

The picture on the first information page is 100 pixels wide and 100 pixels high. 


A-2 


User Records 



APPENDIX 


PowerTalk Built-in Templates 


The sort-order number of the information pages for the User record is: 1000 for the first 
(Business Card) page, 2000 for the second (Personal Info) page, 3000 for the third (Phone 
Numbers) page, and 20000 for the fourth (Electronic Addresses) page. The Electronic 
Addresses page has a much higher sort-order number than the others because it is 
intended always to come last, even if developers add additional information pages 
between it and the other ones. 

The names of the built-in templates for User records are listed in Table A-l. 


Table A-1 Names of AOCE templates for User records 


Template name 

Template type 

Function 

aoce User main aspect 

Aspect 

User record main aspect 

aoce User Info-page Aspect 

Aspect 

Properties for first two pages 

aoce User Info-page 

Information page 

First (Business Card) page 

aoce User Persoanl Info-page 

Information page 

Second (Personal Info) page 

aoce User Phone Aspect 

Aspect 

Properties for third page 

aoce User Phone Info Page 

Information page 

Third (Phone Numbers) page 

aoce Work Phone Aspect 

Aspect 

Aspect for work phone 

aoce Work Phone Info-page 

Information page 

Information page for work phone 

aoce Home Phone Aspect 

Aspect 

Aspect for home phone 

aoce Home Phone Info-page 

Information page 

Information page for home phone 

aoce Mobile Phone Aspect 

Aspect 

Aspect for mobile phone 

aoce Mobile Phone Info-page 

Info-page 

Information page for mobile phone 

aoce Other Phone Aspect 

Aspect 

Aspect for other phone 

aoce Other Phone Info-page 

Info-Information 

Information page for other phone 

Mail Info Page Aspect 

Aspect 

Properties for last page 

Mail Info Page 

Information page 

Last (Electronic Addresses) page 

Drop Send Aspect User 

Aspect 

Drop-send (forwarded to by groups and 
addresses as well) 


NOTE The spelling "Persoanl" in the name of the second information page of a User record is 
correct as shown. 
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Group Records 


Group records have a record type of aoce Group (kGroupRecTypeBody). 

The only standard attribute type in a Group record is aoce Member 

(kMemberAttrTypeBody). 

The Group record information pages are 277 pixels wide by 303 pixels high. The 
page-selection pop-up menu is fixed at location (7, 35, 26, 201) (top, left, bottom, right). If 
you add your own information page to a Group record, it is recommended that you 
include a page-identifying small icon at location (7, 11, 23, 27). 


Addresses 


Within User records and stand-alone attributes, electronic addresses are stored in 
attribute values of type aoce mailslots (kMailSlotsAttrTypeBody). The tag is the 
internal subtype of the address ( ' entn' for PowerShare, 'a lan' for AppleTalk, and so 
forth). 

The ' dett ' pattern for an address must end with a pattern element of type ' Pref ' . 
This custom element type lets the Electronic Addresses information page set the 
preferred address radio buttons correctly. 

The standard address information page is 259 pixels wide by 200 pixels high. It has a 
page-selection pop-up menu at location (8, 56, 30, 206) (top, left, bottom, right). It has 
a page-identifying large icon at (8, 8, 40, 40). Within the page are two radio buttons 
labeled "View as:", one for Fields and one for String. The "View as:" string is at location 
(49, 56, 63, 106). The Fields radio button is at location (48, 111, 64, 154). The String radio 
button is at location (48, 164, 64, 209). Between the view-as selector and the data is a 
dotted line, at location (72, 8, 73, 251). 

Addresses with all types of tags are forwarded to the drop-send aspect by a built-in 
forwarder, so your address template does not need to handle drops. 


Other Built-in Templates 


There are several other templates built into PowerTalk. These include the template for 
the Find-in-Catalog feature, the Key Chain templates, and address templates for 
AppleTalk and PowerShare addresses. These other templates are subject to change 
without notice; for this reason, you should not modify, replace, or otherwise depend on 
them. 
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